home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / insight / ch5.z / ch5
Text File  |  2001-04-17  |  16KB  |  331 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.        This chapter describes the known problems with the current
  11.        release of the IRIS InSight products and how to work around
  12.        them.
  13.  
  14.  
  15.        5.1  _I_R_I_S__I_n_S_i_g_h_t__L_i_b_r_a_r_y
  16.  
  17.           +o Some glossary terms (underlined; or blue, italicized
  18.             terms in the content) might be missing from the
  19.             Glossary.  When you click on such a term, the viewer
  20.             may beep, indicating a warning that the term was not
  21.             found.
  22.  
  23.           +o Make sure the (global) InSight glossary book is
  24.             installed (_i_n_s_i_g_h_t__g_l_o_s_s._b_o_o_k_s._g_l_o_b_a_l) either locally;
  25.             or if you are accessing the InSight Library from a
  26.             remote machine, on that particular machine/server.
  27.  
  28.  
  29.        5.2  _I_R_I_S__I_n_S_i_g_h_t__V_i_e_w_e_r
  30.  
  31.           +o It has been found that the old _i_n_f_o_n_a_v._s_w._b_a_s_e
  32.             subsystem, part of the original _S_u_p_p_o_r_t_f_o_l_i_o release,
  33.             is incompatible and conflicts with this version of
  34.             insight and insight_base. For that reason, it (the
  35.             _i_n_f_o_n_a_v product) should be removed from the system
  36.             prior to installation.  The problem will manifest
  37.             itself in the inability to read the online books.
  38.  
  39.           +o Proximity searching does not function in Japanese books
  40.             since the current proximity algorithm is based on space
  41.             delimited words and Japanese words may not be space
  42.             delimited.
  43.  
  44.           +o In boolean searches using two or more words, only the
  45.             first word will be highlighted in the text.
  46.  
  47.           +o Expanding a search using wildcards may highlight
  48.             improper characters in the text.
  49.  
  50.           +o After installing a new version of the viewer, you
  51.             should remove any local defaults that may have been
  52.             left around by previous versions.  To do this, give
  53.             this command before executing IRIS InSight for the
  54.             first time after an installation:
  55.  
  56.             %%%% rrrrmmmm ~~~~////....iiiinnnnssssiiiigggghhhhttttrrrrcccc
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.           +o Scrolling in the viewer may seem "jumpy" due to the
  75.             rendering of images inline.  A workaround is to use the
  76.             line up and line down buttons in the scroll bar, or the
  77.             <Page Up> and <Page Down> buttons on the keyboard.
  78.             Another alternative is to use the "Settings..." option
  79.             from the Options menu and click on "Figures/Media In-
  80.             line?" to not include figures inline.
  81.  
  82.           +o If the IRIS InSight viewer is running and a new book or
  83.             set of books are installed, IRIS InSight will not
  84.             immediately "see" and utilize the new content. In order
  85.             for IRIS InSight to view the newly-installed book(s),
  86.             close and restart the IRIS InSight application.
  87.  
  88.           +o Occasionally, the book viewer window might be narrower
  89.             than required to display the full width of a table (or
  90.             other in-line object). A warning message:
  91.  
  92.             YYYYoooouuuurrrr wwwwiiiinnnnddddoooowwww iiiissss ttttoooooooo nnnnaaaarrrrrrrroooowwww ffffoooorrrr tttthhhhiiiissss vvvviiiieeeewwww....
  93.             PPPPlllleeeeaaaasssseeee rrrreeeessssiiiizzzzeeee tttthhhheeee wwwwiiiiddddtttthhhh ooooffff tttthhhheeee vvvviiiieeeewwwwiiiinnnngggg aaaarrrreeeeaaaa....
  94.  
  95.             might be generated to the window.  This is not harmful;
  96.             simply widen the window to view the entire object.
  97.  
  98.           +o Make sure that when printing you select one or more
  99.             entries in the Print Window Table-of-Contents area.
  100.  
  101.           +o Printing portions of a book (or a whole book) with
  102.             graphics included can often take a substantial period
  103.             of time. You may wish to consider printing without
  104.             including graphics. From the Print Window, click on
  105.             "Print Graphics?" to not include graphics in the
  106.             printed output.
  107.  
  108.           +o For Systems Administrators, it should be noted that the
  109.             directory /_v_a_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_e_b_t_p_u_b is installed as an
  110.             ``open'' directory, with the permissions being set to
  111.             777. This area is used to store an Insight user's
  112.             bookmarks. Note that this area can be changed through
  113.             the modification of the PUBLIC_DIR and PRIVATE_DIR
  114.             variables found in the IRIS InSight system
  115.             configuration file,
  116.             /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_s_y_s_t_e_m._i_n_s_i_g_h_t_r_c.
  117.  
  118.           +o The following is a suggestion to speed navigation for
  119.             some users. This is simply done by mapping a couple of
  120.             keystrokes to specific scrolling actions. For example,
  121.             the Return Key is used to move down a line in the
  122.             Insight window, and the Space Bar is used to move down
  123.             a page. To do this, these lines go in your .Xdefaults
  124.             or app-defaults file:
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             _I_n_s_i_g_h_t*_X_m_S_c_r_o_l_l_B_a_r._t_r_a_n_s_l_a_t_i_o_n_s: #_o_v_e_r_r_i_d_e \
  141.                 <_K_e_y>_E_n_t_e_r:_I_n_c_r_e_m_e_n_t_D_o_w_n_O_r_R_i_g_h_t(_0)\n\
  142.                 <_K_e_y>_R_e_t_u_r_n:_I_n_c_r_e_m_e_n_t_D_o_w_n_O_r_R_i_g_h_t(_0)\n\
  143.                 <_K_e_y>_s_p_a_c_e:_P_a_g_e_D_o_w_n_O_r_R_i_g_h_t(_0)\n
  144.  
  145.  
  146.        5.3  _S_G_I_H_e_l_p__V_i_e_w_e_r
  147.  
  148.           +o If the SGIHelp is not installed on the user's machine
  149.             when a request is made for Help, you will receive the
  150.             following warning message:
  151.  
  152.             SSSSGGGGIIIIHHHHeeeellllpppp sssseeeerrrrvvvveeeerrrr pppprrrrooooggggrrrraaaammmm ((((////uuuussssrrrr////ssssbbbbiiiinnnn////ssssggggiiiihhhheeeellllpppp)))) nnnnooootttt ffffoooouuuunnnndddd....
  153.             PPPPlllleeeeaaaasssseeee iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....ssssggggiiiihhhheeeellllpppp aaaannnndddd ttttrrrryyyy aaaaggggaaaaiiiinnnn....
  154.  
  155.             Installing the insight.sw.sgihelp subsystem will remedy
  156.             the problem.
  157.  
  158.           +o Occasionally, when a help request is made from an
  159.             application, an informational message may come from the
  160.             SGIHelp process:
  161.  
  162.             SSSSoooorrrrrrrryyyy,,,, iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn oooonnnn tttthhhheeee rrrreeeeqqqquuuueeeesssstttteeeedddd hhhheeeellllpppp ttttooooppppiiiicccc iiiissss nnnnooootttt aaaavvvvaaaaiiiillllaaaabbbblllleeee....
  163.             YYYYoooouuuu nnnneeeeeeeedddd ttttoooo iiiinnnnssssttttaaaallllllll cccceeeerrrrttttaaaaiiiinnnn IIIIRRRRIIIISSSS IIIInnnnSSSSiiiigggghhhhtttt bbbbooooooookkkkssss.... FFFFoooorrrr tttthhhheeee pppprrrroooodddduuuucccctttt yyyyoooouuuu
  164.             aaaarrrreeee rrrreeeeqqqquuuueeeessssttttiiiinnnngggg hhhheeeellllpppp oooonnnn,,,, yyyyoooouuuu nnnneeeeeeeedddd ttttoooo iiiinnnnssssttttaaaallllllll tttthhhheeee bbbbooooooookkkk((((ssss)))) iiiinnnn tttthhhheeeesssseeee
  165.             ssssuuuubbbbssssyyyysssstttteeeemmmm((((ssss)))):::: <<<<<<<<bbbbooooooookkkk____nnnnaaaammmmeeee>>>>>>>> <<<<<<<<bbbbooooooookkkk____ssssuuuubbbbssssyyyysssstttteeeemmmm>>>>>>>>
  166.  
  167.             This message indicates that the Help content for this
  168.             application has not been installed. Refer to the the
  169.             "Installation Information" found in this document, or
  170.             refer to the release notes for the application that you
  171.             wish to receive help on, for further information.
  172.  
  173.           +o If the on-line books are being mounted from another
  174.             source, and are not installed locally, the directory
  175.             /usr/share/help should also be mounted (or copied) from
  176.             the same source. This directory contains application
  177.             helpmap files which aid SGIHelp in determining what
  178.             information to display for a given help request.
  179.  
  180.           +o When mounting IRIS InSight books, be aware that SGIHelp
  181.             looks for books under two specific locations. One is
  182.             the default /usr/share/Insight/library/SGI_bookshelves,
  183.             which should contain the English version of all
  184.             available books. The other is the international setting
  185.             of /usr/share/Insight/library/<locale>_bookshelves,
  186.             where <locale> is the value of the LANG environment
  187.             setting. In the case where LANG is set, SGIHelp will
  188.             look first under the <locale>_bookshelves area, and if
  189.             the requested localized help information is not found,
  190.             it will fall back to the default (SGI_bookshelves) and
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.             examine the English books.
  207.  
  208.           +o The SGIHelp process itself will tell the user if
  209.             content is unavailable.  Upon receiving a request, it
  210.             will start up (if not already running), and display the
  211.             message:
  212.  
  213.  
  214.             CCCCaaaannnnnnnnooootttt ffffiiiinnnndddd aaaannnnyyyy bbbbooooooookkkkssss ttttoooo rrrreeeeaaaadddd!!!! EEEExxxxiiiittttiiiinnnngggg............
  215.  
  216.             Re-mounting the file system off the CD-ROM (or server)
  217.             from which you were accessing content and making
  218.             another help request from an application should remedy
  219.             this. The alternative is to install the applicable IRIS
  220.             Insight books on your hard disk.
  221.  
  222.             Refer to the "Installation Information" found in this
  223.             document, or to the release notes for the application
  224.             that you wish to receive help on, for further
  225.             information.
  226.  
  227.           +o Under IRIX 6.2, when starting the sgihelp process or
  228.             the desktophelp executable from the command-line
  229.             (shell), the following warning messages may be
  230.             displayed in the shell or console window:
  231.  
  232.  
  233.             WWWWaaaarrrrnnnniiiinnnngggg:::: CCCCoooouuuulllldddd nnnnooootttt ffffiiiinnnndddd SSSScccchhhheeeemmmmeeee ffffiiiilllleeee:::: IIIImmmmddddPPPPaaaalllleeeetttttttteeee
  234.             WWWWaaaarrrrnnnniiiinnnngggg:::: CCCCoooouuuulllldddd nnnnooootttt ffffiiiinnnndddd SSSScccchhhheeeemmmmeeee ffffiiiilllleeee:::: IIIImmmmddddSSSSppppeeeecccc
  235.  
  236.             These messages are harmless and can be safely ignored.
  237.  
  238.           +o The "Stop" button on the SGIHelp viewer is only
  239.             activate when loading a web-based (or local HTML) help
  240.             document.
  241.  
  242.  
  243.        5.4  _S_G_I_H_e_l_p__D_e_v_e_l_o_p_m_e_n_t__(_s_g_i_h_e_l_p___d_e_v_)
  244.  
  245.           +o In order to avoid a potential problem in accessing the
  246.             first available help card in your help book, you may
  247.             wish to put in a copyright notice as the first card
  248.             when you are authoring your book. That particular card
  249.             does not have to be accessible by the interface; it
  250.             basically acts as a filler to avoid a potential
  251.             problem.
  252.  
  253.             Here is a recommended template for the copyright
  254.             notice, which would appear directly after the <DOCHELP>
  255.             opening tag:
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             <<<<FFFFRRRROOOONNNNTTTTMMMMAAAATTTTTTTTEEEERRRR>>>>
  273.             <<<<CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT>>>>
  274.             CCCCooooppppyyyyrrrriiiigggghhhhtttt 1111999999998888,,,, """"yyyyoooouuuurrrr____ccccoooommmmppppaaaannnnyyyy"""" ---- AAAAllllllll RRRRiiiigggghhhhttttssss RRRReeeesssseeeerrrrvvvveeeedddd
  275.             <<<<////CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT>>>>
  276.  
  277.             <<<<PPPPAAAARRRRAAAAGGGGRRRRAAAAPPPPHHHH>>>>
  278.             TTTThhhhiiiissss ddddooooccccuuuummmmeeeennnntttt ccccoooonnnnttttaaaaiiiinnnnssss pppprrrroooopppprrrriiiieeeettttaaaarrrryyyy aaaannnndddd ccccoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn ooooffff
  279.             """"yyyyoooouuuurrrr____ccccoooommmmppppaaaannnnyyyy"""".... TTTThhhheeee ccccoooonnnntttteeeennnnttttssss ooooffff tttthhhhiiiissss ddddooooccccuuuummmmeeeennnntttt mmmmaaaayyyy nnnnooootttt bbbbeeee ddddiiiisssscccclllloooosssseeeedddd
  280.             ttttoooo tttthhhhiiiirrrrdddd ppppaaaarrrrttttiiiieeeessss,,,, ccccooooppppiiiieeeedddd,,,, oooorrrr dddduuuupppplllliiiiccccaaaatttteeeedddd iiiinnnn aaaannnnyyyy ffffoooorrrrmmmm,,,, iiiinnnn wwwwhhhhoooolllleeee oooorrrr
  281.             iiiinnnn ppppaaaarrrrtttt,,,, wwwwiiiitttthhhhoooouuuutttt tttthhhheeee pppprrrriiiioooorrrr wwwwrrrriiiitttttttteeeennnn ppppeeeerrrrmmmmiiiissssssssiiiioooonnnn ooooffff """"yyyyoooouuuurrrr____ccccoooommmmppppaaaannnnyyyy""""....
  282.             <<<<////PPPPAAAARRRRAAAAGGGGRRRRAAAAPPPPHHHH>>>>
  283.             <<<<////FFFFRRRROOOONNNNTTTTMMMMAAAATTTTTTTTEEEERRRR>>>>
  284.  
  285.           +o The insight.sw.xhelp_dev subsystem requires dev.sw.make
  286.             and inst_dev.sw.base which are available via the IDO
  287.             product.  These are not specified as pre-req's since
  288.             not all user's will have IDO.  However, they are only
  289.             required for the ``smake'' and ``gendist'' utilities
  290.             for making and building the help images.  Changing the
  291.             reference from ``smake'' to ``make'' in the Makefile's
  292.             should allow user's to build the sample books.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.